home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 026a / atbbsdbf.zip / PORTLIST.DOC < prev    next >
Text File  |  1990-12-14  |  3KB  |  85 lines
  1. Documentation for PORTLIST.DBO
  2.  
  3.  
  4. PORTLIST is a dBaseIV batch process that will import the file
  5. FILES. that you downloaded from the ATBBS MAIN library.  This
  6. file contains the names and locations of all files on the BBS.
  7.  
  8. The database ATBBS.DBF will contain a list of the files in the
  9. FILES. file.  This database file will contain the following
  10. information:
  11.  
  12.    LIBRARY     ->  ATBBS library name where the file resides
  13.    FILE        ->  The name and extension of the file
  14.    BYTES       ->  The size of the file
  15.    SOURCE      ->  Where did the file come from (BBS USER)
  16.    DESCRIP     ->  Brief description of the file
  17.    NEW         ->  Logical field -- is the file new?
  18.    DOWNLOADED  ->  Logical field -- use this field to help keep
  19.                    track of the files you have down loaded.
  20.  
  21.  
  22. A few things about the program:
  23.  
  24.  
  25. 1.  First off, I am fairly new to dBase and do not claim to be 
  26.     an expert.  If you find ways that I could have made this 
  27.     program better, please let me know.  I need the help.  
  28.  
  29.     Please send any comments you may have and go a lttle easy,
  30.     like I said I'm fairly new to dBase.
  31.  
  32.  
  33. 2.  There are no error checking routines done.  This was a "down
  34.     and dirty get it over with quick thing".
  35.  
  36.  
  37. 3.  The first time you use this program, ALL files in the
  38.     ATBBS.DBF will be marked as new files.  Be sure you really 
  39.     want all of them printed out before answering "Y" to the print
  40.     prompt.
  41.  
  42.     Once new files are printed, the NEW field is reset to .F. so
  43.     if you don't want all the files printed, you will need to
  44.     change the contents of the NEW field yourself.
  45.  
  46.     FOR THOSE WHO ARE NEWER TO DBASE THAN I AM YOU CAN DO THIS
  47.     BY TYPING IN THE FOLLOWING LINE AT THE DOT PROMPT:
  48.  
  49.     REPLACE ALL NEW WITH .F.
  50.  
  51.  
  52. 4.  There is a UDF called NOCOPY in the program.  It is the last
  53.     one in the file and is located there on purpose.  
  54.  
  55.     The main purpose of this function is to allow you to decide
  56.     what libraries you are interested in.  OK, in plain english ...
  57.     If you are not interested in keeping track of files in a
  58.     library, this function will allow you to flag those files so
  59.     they won't be copied to the ATBBS.DBF.
  60.  
  61.     You will need to modify the function to suit your purposes.
  62.     I have included a couple of samples in the code.
  63.  
  64.     The main thing to remember is that if the function returns .T.
  65.     the file will NOT be copied.  You have your choice of
  66.     coding for files to include or file to exclude.
  67.  
  68. 5.  I wrote this little program because I am new to the BBS
  69.     (much newer to it than to dBase) and wanted a way to keep
  70.     track of the available files for down loading.
  71.  
  72.  
  73. 6.  Re-read #1 above.
  74.  
  75.  
  76. FILES AND DESCRIPTIONS
  77.  
  78.    PORTLIST.*       -> The program
  79.    NEW.*            -> Report form for the PORTLIST program
  80.    ATBBS.DBF        -> The database file that you will use to
  81.                        track the BBS files
  82.    READFILE.DBF     -> Used to import the "FILES." file
  83.    TEMPATBB.DBF     -> Temporary database used to move records
  84.                        from the READFILE.DBF into the ATBBS.DBF
  85.